Group Include or Redirect

Summary

Redirects the caller to a document or includes a document based on the callers membership in one or more groups.

Component properties
Category	AS Security
Version	1.0
Complies with Xhtml 1.0 / 1.1 rules	Yes
Supported server programming languages	C# Visual Basic.NET
Output content type	Unspecified or not applicable

When to use

This component is typically used in an Intranet scenario when there is a need to only allow members of one or more groups access to a resource.

Programming interface

Group Include or Redirect

Version:

1.0

Description:

Redirects the caller to a document or includes a document based on the callers membership in one or more groups.

Server language:

c#|vb

Group name:

A group to check the caller's memberships for. This parameter is ignored if a group filter is supplied.

Groupfilter:

variable name

A list of one or more groups surrounded by pipes(|) that will be used to compare the caller's memberships with. The groupnames must be written in the inverse NTLM-format (Groupname\Domain). Example: |MyGroup\MyDomain||YourGroup\YourDomain|
NOTE: If you call "Group include or redirect" directly from code the normal NTLM format should be used.

Groupfilter evaluation rule:

Indicates how the groups in the Groupfilter must match the caller's memberships in order to evaluate to true. All = all groups must match, Any = Any group in the filter that the caller is a member of will do.

Actions to be taken when the caller is a member

Action:

A document that should either be included or redirected to if the caller is a member of the group specified in the Group property or the caller's group memberships matches the Groupfilter.

Target document:

A document that should either be included or redirected to if the caller is a member of the group specified in the Group property or the caller's group memberships matches the Groupfilter.

Presentation template:

Optional presentation template to use with the target document.

Actions to be taken when the caller not is a member

Action:

A value that indicates whether to redirect to the alternate target, or include the alternate target when the caller is not a member of the group specified in the Group property or the caller's group memberships does not match the Groupfilter

Target document:

A document that should either be included or redirected to if the caller is not a member of the group specified in the Group property or the caller's group memberships does not match the Groupfilter.

Presentation template:

Optional presentation template to use with the alternate target document.

Group Include or Redirect: programming interface

Parameters

Group name: A group to check the caller's memberships for. This parameter is ignored if a group filter is supplied.
Groupfilter: A list of one or more groups surrounded by pipes(|) that will be used to compare the caller's memberships with. The groupnames must be written in the inverse NTLM-format (Groupname\Domain). Example: |MyGroup\MyDomain||YourGroup\YourDomain|
NOTE: If you call "Group include or redirect" directly from code the normal NTLM format should be used.
Groupfilter evaluation rule: Indicates how the groups in the Groupfilter must match the caller's memberships in order to evaluate to true. All = all groups must match, Any = Any group in the filter that the caller is a member of will do.
Actions to be taken when the caller is a member
Action: A document that should either be included or redirected to if the caller is a member of the group specified in the Group property or the caller's group memberships matches the Groupfilter.
Target document: A document that should either be included or redirected to if the caller is a member of the group specified in the Group property or the caller's group memberships matches the Groupfilter.
Presentation template: Optional, a presentation template to use with the target document.
Actions to be taken when the caller not is a member
Action: A value that indicates whether to redirect to the alternate target, or include the alternate target when the caller is not a member of the group specified in the Group property or the caller's group memberships does not match the Groupfilter
Target document: A document that should either be included or redirected to if the caller is not a member of the group specified in the Group property or the caller's group memberships does not match the Groupfilter.
Presentation template: Optional, a presentation template to use with the target document to use when the caller is not a member.

The Group Include or Redirect AS component

Summary

When to use

Programming interface

Parameters

Remarks